home *** CD-ROM | disk | FTP | other *** search
/ Sun Solutions 1997 April to September / Sun Solutions CD - APR '97 - SEP '97 (704-3778-12 Rev. H)(Sun Microsystems, Inc.)(1997).iso / products / Hyperion / src / README.hpux < prev    next >
Text File  |  1997-02-26  |  4KB  |  79 lines
  1. Note: Hewlett Packard supplies this without warranty or support of any kind.
  2.  
  3. WorkMan was ported to HPUX by John Brezak (brezak@apollo.hp.com).  Bug
  4. reports should still be sent to me at koreth@hyperion.com, though; I have
  5. access to HPs and can probably fix most problems.
  6.  
  7. This program should compile and run on series 700 machines under HPUX 9.0
  8. or higher.  There is some support for HPUX 8.07, but it's currently broken;
  9. if you want to take a stab at fixing it, check plat_hpux.c.
  10.  
  11. You will need the XView toolkit, version 3.0 or higher.  An HPUX port of
  12. XView is available from many sites via anonymous ftp.  Use archie to find
  13. one near you.  Neither John nor I can supply people with XView sources, so
  14. please don't ask.  ftp.csc.liv.ac.uk is one place you'll find XView for the
  15. HP, though I'm sure they'd appreciate it if you tried to find a closer site
  16. before using theirs.
  17.  
  18. There is a WorkMan binary at ftp.hyperion.com:/WorkMan/hp700.tar.Z if you
  19. can't find XView or don't want to bother installing it.
  20.  
  21. You may also need to install the OPEN LOOK fonts to use this program.
  22. They are available from ftp.hyperion.com as well as with the generic XView
  23. source distribution, available widely in the contrib section of X11R5.
  24. You do not need to build XView from source to get the fonts from the
  25. source distribution.  They're included in the XView tarfiles on
  26. ftp.csc.liv.ac.uk.
  27.  
  28. The supplied Makefile (Makefile.hpux) will need to be tweaked to point to
  29. your XView include files and libraries.  You might also be able to generate
  30. a valid Makefile with "imake".  I haven't tested that.
  31.  
  32. You'll want to put the following in your X resources:
  33.  
  34.     openWindows.windowColor:        #CCCCCC
  35.  
  36. Make "/dev/rscsi" a link to the CD-ROM's raw disk device.  For instance,
  37. if your CD-ROM drive is at SCSI target number 5, you'd do (as root):
  38.  
  39.     ln -s /dev/rdsk/5s0 /dev/rscsi
  40.  
  41. Or, if you prefer, use the "-c" option when running the program to tell
  42. it to use a device name other than /dev/rscsi.
  43.  
  44. To use the program's spot help, you'll need to define a Help key, since
  45. there isn't one on the HP keyboard.  Use the "xmodmap" program to do it.
  46. For instance, the following will define the numeric keypad's "0" key as
  47. the help key:
  48.  
  49.     xmodmap -e "keysym KP_0 = Help"
  50.  
  51. Once you have a Help key defined, position the mouse pointer over a control
  52. and hit the key.  For this to work, you will either need to install the
  53. "workman.info" file in /usr/lib/help or set your HELPPATH environment
  54. variable to point to the directory where the .info file lives.
  55.  
  56. For those who'd like to read through the source, note that the HPUX-specific
  57. code is contained in plat_hpux.c.
  58.  
  59. The authoritative guide to controlling the HP CD-ROM drive (which is actually
  60. a Toshiba XM3301) is the Toshiba XM3301 User's Manual.  If you want to look
  61. at it, contact Toshiba.
  62.  
  63.  
  64. HP-SPECIFIC PROBLEMS:
  65.  
  66. When there's no CD in the drive, WorkMan is very slow.  As far as I can tell,
  67. this is a hardware limitation -- the drive takes a long time to respond when
  68. there's no CD present, and WorkMan is stuck waiting for the response in the
  69. meantime.  If anyone knows a workaround, please get in touch with me.  You
  70. can run with "-ee" if you find this behavior annoying (see the man page).
  71.  
  72. The Toshiba drive doesn't allow the volume to be adjusted from software, so
  73. WorkMan's volume controls are greyed out and can't be manipulated.
  74.  
  75. The mwm window manager (a derivative of which is used as the VUE window
  76. manager) chops off part of the WorkMan icon.  This is an mwm problem; I'm
  77. not aware that there's anything I can do to tell mwm to give the icon more
  78. room.
  79.